home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro122 / write.doc < prev    next >
Encoding:
Text File  |  1993-07-05  |  11.1 KB  |  306 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         
  8.                             
  9.                             
  10.                             
  11.                             
  12.                             
  13.                             
  14.                             
  15.                             
  16.                             
  17.                             
  18.                             
  19.                             
  20.                             
  21.                             
  22.                             
  23.                             
  24.                                STEENBURGH'S STUFF
  25.                             Mildly Useful Utilities
  26.                                 For Batch Files
  27.                                  Version  3.0
  28.           Copyright 1991-1993 by Chuck Steenburgh and Tay-Jee Software
  29.         
  30.                              _______
  31.                         ____|__     |               (TM)
  32.                      --|       |    |-------------------
  33.                        |   ____|__  |  Association of
  34.                        |  |       |_|  Shareware
  35.                        |__|   o   |    Professionals
  36.                      -----|   |   |---------------------
  37.                           |___|___|    MEMBER
  38.         
  39.         
  40.         
  41.         
  42.         
  43.         
  44.         
  45.         
  46.         
  47.         
  48.         
  49.         
  50.         
  51.         
  52.         
  53.         
  54.         
  55.         
  56.         
  57.         
  58.         
  59.         
  60.         
  61.  
  62.                                      Page 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.         WRITE.EXE 2.5
  69.         Copyright 1991-1993 Chuck Steenburgh & Tay-Jee Software
  70.         
  71.         
  72.            We know that ECHO has its limits, don't we?  WRITE will let
  73.         you have full control over the positioning and color of your
  74.         text messages in batch files.  Version 2.0 adds the capability
  75.         to have write display text files, similar to DOS's TYPE|MORE
  76.         combination, but in FULL color that you specify.
  77.         
  78.         Syntax:       
  79.         
  80.              WRITE "Text"|@file [ccc] [/C] [/Rn] [/Ln] [/S] [/X|/N] [/H]|
  81.         
  82.                   "Text"          This is the text to be displayed,
  83.                                   which must be enclosed in quotes if
  84.                                   it consists of more than one word.
  85.                                   
  86.                   @file           Name of file containing ASCII text to
  87.                                   be displayed.  Can be specified in
  88.                                   lieu of "Text."
  89.                                                                    
  90.                   ccc             This is the color in which to print
  91.                                   the text.  See Appendix 3.
  92.                                   
  93.                   /C              Centers text on line.
  94.         
  95.                   /Rn             n is the row (0-24, top to bottom) on
  96.                                   which the text will appear.  The de-
  97.                                   fault is to use the current cursor
  98.                                   position.
  99.                                                                      
  100.                   /Ln             n is the column (0-79, left to right)
  101.                                   where the text will begin printing.
  102.                                   The default is to use the current cur-
  103.                                   sor position.
  104.         
  105.                   /S              Include this switch to utilize slow
  106.                                   (BIOS) screen writes.  This will
  107.                                   suppress "snow" on some CGA displays.
  108.                   
  109.                   /X | /N         Places screen in eXtended (43/50 line)|
  110.                                   mode or Normal (25 line) mode on EGA  |
  111.                                   or VGA systems.                       |
  112.                                   
  113.                   /H              Displays brief help screen.
  114.         
  115.         Examples:
  116.         
  117.              WRITE "This is my message"
  118.              
  119.              Displays "This is my message" on the current line in gray
  120.         on black background (same as ECHO This is my message, only
  121.         MUCH faster).
  122.  
  123.                                      Page 2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.         
  130.              WRITE "This is my message." 79
  131.              
  132.              Displays "This is my message." on the current line in
  133.         bright white on red background.
  134.         
  135.              WRITE "Hello, Chuck." /r10 /l25
  136.              
  137.              Displays "Hello, Chuck." on row 10, column 25, in gray on
  138.         black background.
  139.         
  140.              WRITE "Goodbye, Chuck." /r5 /c /s 207
  141.              
  142.              Displays "Goodbye, Chuck." centered on row 5 in flashing
  143.         bright white on red background.  Suppresses snow on old CGA sys-
  144.         tems.
  145.         
  146.              WRITE @write.doc 15
  147.              
  148.              Displays this documentation file on the screen in bright
  149.         white on black background. 
  150.         
  151.            If a text file is to be displayed, the /L, /R, and /C switch-|
  152.         es are ignored.  The screen will be cleared, and text will be   |
  153.         displayed a screen at a time.  Users will be prompted with the  |
  154.         familiar "Press any key to continue..." message to continue on  |
  155.         to the next screen.                                             |
  156.         
  157.            WRITE returns errorlevels as follows:
  158.         
  159.              0   Normal termination                                     
  160.              1   Text file displayed
  161.              2   Help screen displayed
  162.         
  163.            Note to users of WRITE 1.1 or 1.0:
  164.            
  165.            Commands written for earlier versions of WRITE are not com-
  166.         patible with WRITE 2.x.  Sorry, but the new features included
  167.         with WRITE 2.0 demanded a different system of passing parameters
  168.         to the program.  The current switches are similar to those used
  169.         with the remainder of STEENBURGH'S STUFF utilities.  The original
  170.         two releases of WRITE were little more than executable versions 
  171.         of some "C" functions I had written for use in other programs, 
  172.         while version 2.0 is a completely new, much more flexible and 
  173.         capable utility.
  174.         
  175.          
  176.         OMBUDSMAN
  177.         
  178.           This program is produced by a member of the Association of
  179.         Shareware Professionals (ASP).  ASP wants to make sure that
  180.         the shareware principle works for you.  If you are unable to
  181.         resolve a shareware-related problem with an ASP member by
  182.         contacting the member directly, ASP may be able to help.  The
  183.  
  184.                                      Page 3
  185.  
  186.  
  187.  
  188.  
  189.  
  190.         ASP Ombudsman can help you resolve a dispute or problem with
  191.         an ASP member, but does not provide technical support for 
  192.         members' products.  Please write to the ASP Ombudsman at 545
  193.         Grover Road, Muskegon, MI 49442 or send a CompuServe message
  194.         via CompuServe Mail to ASP Ombudsman, 70007,3536.
  195.         
  196.         
  197.         DISCLAIMER
  198.         
  199.            The programs described in this documentation are guaran-
  200.         teed to do absolutely nothing!  They have, however, in my exper-
  201.         ience performed essentially as described herein.  The author
  202.         will not be responsible for any loss or damages caused through
  203.         the use of these programs.  No warranty, express or implied,
  204.         is provided for this software's performance, merchantability,
  205.         or fitness for a particular purpose.
  206.         
  207.            All trademarks are property of their respective owners.
  208.         
  209.            The programs and documentation are Copyright 1991,1992 by 
  210.         Chuck Steenburgh.  You are encouraged to distribute these pro-
  211.         grams provided the following conditions are met:
  212.         
  213.            - all files contained in the archive or distribution disk
  214.              must be distributed together in UNMODIFIED form
  215.         
  216.            - you charge no more than a reasonable fee for copying or
  217.              subscription, and clearly indicate that payment of such
  218.              a fee does NOT grant ownership of the programs.
  219.         
  220.            This program is part of set of utilities known as STEEN-
  221.         BURGH'S STUFF (Mildly Useful Utilities).  The full set of
  222.         utilities includes the following programs:
  223.         
  224.              BATBOX:     Simple menu creation/input system
  225.              CHKDRV:     Checks disk drive status
  226.              CHKPRN:     Checks parallel printer status
  227.              CLK:        Displays time on screen
  228.              CURSOR:     Change cursor shape
  229.              DOSVER:     Checks for DOS version currently running
  230.              INPUT:      Simple prompt/input system
  231.              KLS:        Colorful screen-clearing utility
  232.              LAUNCHER:   File selection/execution system
  233.              MUSIC:      Plays transcribed sheet music on the PC
  234.              RAND:       Random number generator
  235.              SKIP:       Prints blank lines from batch files
  236.              SOUNDER:    Wide range of noise making options
  237.              SPACE:      File/disk space reporting utility
  238.              WAITFOR:    Timed pauses 
  239.              WHENISIT:   Date/time telling utility
  240.              WRITE:      Colorful output anywhere on screen
  241.              XD:         Create/switch directories at the same time
  242.         
  243.            You may evaluate these programs for up to 30 days on a free
  244.  
  245.                                      Page 4
  246.  
  247.  
  248.  
  249.  
  250.  
  251.         trial basis.  After 30 days, you should register your use of
  252.         these programs.  The registration fee is $20, payable to the
  253.         author at the address given below.  For those registering
  254.         directly with Tay-Jee Software, we offer a $5 cash discount.
  255.         
  256.            Let's be real: I don't plan to make a lot of money this way.
  257.         Registration does have its advantages:
  258.         
  259.            - I am improving these programs all the time.  Registration
  260.              will get you IMMEDIATELY a disk with the latest version.
  261.              You will also get the next major release of the program set
  262.              sent to you free of charge.
  263.         
  264.            - While I can't promise to include everyone's suggestions
  265.              in program updates, you can bet I'll listen to registered
  266.              users before any of you scrounges out there.
  267.         
  268.            - You will make me feel all warm and fuzzy and appreciated, 
  269.              and all that good stuff.
  270.         
  271.            - You will also get an evaluation copy of my text file for-
  272.              matting program (used to produce the margins in this doc-
  273.              ument), and any other electronic creations I have decided
  274.              to unleash on a foolish, unsuspecting world.
  275.         
  276.            Send comments/registrations to:
  277.         
  278.                 Tay-Jee Software
  279.                 Post Office Box 835
  280.                 Lexington, VA 24450
  281.                 (703)464-5290
  282.                 
  283.                 !!!VIRGINIA RESIDENTS ADD 4.5SALES TAX!!!
  284.         
  285.                 CIS 72330,1776 (I haunt the IBMSYS and IBMPRO forums)
  286.         
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.                                      Page 5